PATH  Mac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Icon Services and Utilities
>
Obtaining and Using Icons With Icon Services

   

'badg'

The 'badg' resource contains information about badges that your application can specify to overlay or replace other icons.

struct CustomBadgeResource
{
UInt16 version;                 // This is version 0

SInt16 customBadgeResourceID;   // If not 0, ID of resource to use
                                // on top of icon for this file or folder

OSType customBadgeType;         // If not 0, type and creator of icon
OSType customBadgeCreator;      // to use on top of existing icon

OSType windowBadgeType;         // If not 0, type and creator of icon
OSType windowBadgeCreator;      // to display in window header
                                // for this file or folder

OSType overrideType;            // If not 0, type and creator of icon to
OSType overrideCreator;         // use INSTEAD of the icon for this file
                                // or folder
};

version
An unsigned integer value. This is currently set to 0, but may change in the future.

customBadgeResourceID
A signed integer value. This value specifies a custom icon resource to use as an overlay for the icon associated with this file or folder. The icon resource should be in the same file as the 'badg' resource.

customBadgeType
A value of type OSType . This four-character value specifies the type code of a registered icon to use as an overlay for the regular icon for this file or folder. If you do not wish to use an overlay, set the value of the customBadgeType field to 0.

customBadgeCreator
A value of type OSType . This four-character value specifies the creator code of a registered icon to use as an overlay for the regular icon for this file or folder. If you do not wish to use an overlay, set the value of the customBadgeCreator field to 0.

windowBadgeType
A value of type OSType . This four-character value specifies the type code for a registered icon to display in the window header of a Finder window displaying this object. If you do not wish to specify a window header icon, set the value of the windowBadgeType field to 0.

windowBadgeCreator
A value of type OSType . This four-character value specifies the creator code for a registered icon to display in the window header of a Finder window displaying this object. If you do not wish to specify a window header icon, set the value of the windowBadgeCreator field to 0.

overrideType
A value of type OSType . This four-character value specifies the type code for a registered icon to replace the standard icon for this object. If you do not wish to specify a replacement icon, set the value of the overrideType field to 0.

overrideCreator
A value of type OSType . This four-character value specifies the creator code for a registered icon to replace the standard icon for this object. If you do not wish to specify a replacement icon, set the value of the overrideCreator field to 0.

overrideCreator

Glossary


© 1999 Apple Computer, Inc. – (Last Updated 03 Dec 99)